Plan de Formación de Backend

FISIO FIND - PLAN DE FORMACIÓN DE BACKEND

---

ÍNDICE

• 1. INTRODUCCIÓN
• 2. INSTALACIÓN DE POSTGRESQL 16.8
• 3. LANZAR LA APLICACIÓN
• 4. CREACIÓN DE UN MODELO

---

Ficha del documento

• Nombre del Proyecto: Fisio Find

• Número de Grupo: Grupo 6

• Entregable: #SPRINT 1

• Miembros del grupo: Alberto Carmona Sicre, Antonio Macías Ferrera, Benjamín Ignacio Maureira Flores, Francisco Capote García, Daniel Alors Romero, Daniel Fernández Caballero, Daniel Ruiz López, Daniel Tortorici Bartús, Daniel Vela Camacho, Delfín Santana Rubio, Guadalupe Ridruejo Pineda, Julen Redondo Pacheco, Miguel Encina Martínez, Francisco Mateos Villarejo, Pablo Fernández Pérez, Ramón Gavira Sánchez, Rafael Pulido Cifuentes.

• Contribuidores: Miguel Encina Martínez (autor), Ramón Gavira Sánchez (autor)

• Fecha de Creación: 16/02/2025

• Versión: v1.1

---

Histórico de Modificaciones

Fecha	Versión	Realizada por	Descripción de los cambios
16/02/2025	v1.0	Miguel Encina Martínez, Ramón Gavira Sánchez	Creación del documento.
08/03/2025	v1.1	Antonio Macías Ferrera	Correcciones menores y exportar a pdf.

1. INTRODUCCIÓN

En este documento se especifica el proceso de instalación y configuración de las herramientas necesarias para ejecutar la aplicación en un entorno local. Además, se incluye un ejemplo práctico del desarrollo CRUD (Create, Read, Update, Delete) de la entidad AppUser, junto con referencias a los tutoriales utilizados para su implementación.

2. INSTALACIÓN DE POSTGRESQL 16.8

1. Windows y macOS:

   • Descargar el instalador oficial de PostgreSQL
   • Seguir el asistente de instalación
   • Guardar la contraseña de superusuario proporcionada durante la instalación
   • No es necesario instalar Stack Builder al final del proceso

2. Configuración inicial:

   • Abrir pgAdmin 4 (interfaz gráfica de PostgreSQL)
   • Conectarse al servidor PostgreSQL utilizando la contraseña de superusuario
   • En el panel izquierdo, hacer clic derecho en "Databases"
   • Seleccionar "Create" > "Database"
   • Nombre de la base de datos: fisiofind
   • Propietario: postgres
   • Guardar los cambios

3. LANZAR LA APLICACIÓN

1. Crear y activar el entorno virtual:

cd backend
python -m venv venv  # Crear entorno virtual

2. Activar el entorno virtual

source venv/bin/activate # Para MacOS/Linux
venv/bin/activate # Para Windows

pip install -r requirements.txt

cp .env.example .env

Sustituye SECRET_KEY de .env por la clave secreta de Django (Grupo de Avisos de WhatsApp) Sustituye DATABASE_NAME, DATABASE_USER, DATABASE_PASSWORD por los datos de tu base de datos en PostgresSQL.

• SECRET_KEY : Clave secreta de Django (disponible en el grupo de WhatsApp)
• DATABASE_NAME : Nombre de la base de datos (fisiofind)
• DATABASE_USER : Usuario de PostgreSQL (postgres por defecto)
• DATABASE_PASSWORD : Contraseña establecida durante la instalación
• DATABASE_HOST : localhost
• DATABASE_PORT : 5432

cd fisio_find
python manage.py makemigrations  # Crear migraciones de la base de datos
python manage.py migrate         # Aplicar migraciones
python manage.py createsuperuser # Crear usuario administrador
python manage.py runserver       # Iniciar servidor de desarrollo

4. CREACIÓN DE UN MODELO

Para implementar nuevos modelos en la aplicación, se recomienda seguir estos tutoriales en orden:

1. https://www.django-rest-framework.org/tutorial/1-serialization/#tutorial-1-serialization (hasta “Using ModelSerializers”)

• Seguir hasta la sección "Using ModelSerializers"
• Conceptos clave: Modelos, Serializadores, Vistas

2. https://dev.to/entuziaz/django-rest-framework-with-postgresql-a-crud-tutorial-1l34 (A partir de “Creating a REST API with Django Rest Framework”)

• Comenzar desde "Creating a REST API with Django Rest Framework"
• Implementación práctica de operaciones CRUD

Para realizar consultas a la API, se puede hacer uso de la herramienta de Postman (https://www.postman.com/downloads/) o introduciendo la url correspondiente en cualquier navegador, que te llevará a un asistente de la API de Django.